Hello, 各位 iT 邦幫忙 的粉絲們大家好~~~

這系列文源自這幾年在團隊裡導入 AI Coding 之後，一路踩雷、修正、再踩雷的真實過程。把這些收斂出來的方法整理成文，也許對正在煩惱同樣問題的你會有些幫助。

就當作是一份邊做邊記的工程筆記吧！

本篇是 當 AI 加入團隊：打造可審查、可驗證、會自我改善的 AI 開發工作流 系列文的 EP10。

規則、技能、流程都寫好了，卻常常卡在一個很基本的問題。

在另一個產品的 repo 裡工作時，AI 根本不知道有這一整套共用規則存在。文件寫得再完整，如果 AI 一開始就沒讀到，就等於不存在。

所以我們在每個會用到這套工作流的產品 repo 裡，放了一份極簡的入口指標：

<!-- product-repo/AGENTS.md -->
# AI 入口指標

本 repo 使用共用 AI 工作流工具箱，請先讀取：
`%USERPROFILE%\AIOrchestrations\AGENTS.md`

不要在此檔案內展開完整 SOP；SOP 一律以共用工具箱為準。

這份指標刻意寫得很短，只做一件事：告訴 AI「完整規則在別的地方，先去讀那裡」。

我們特別避免把完整 SOP 複製貼上到每個產品 repo，理由很直接——一旦複製了兩份，遲早會有一份沒被更新到，屆時 AI 到底該信哪一份？

這也連動到一支安裝腳本，用來在產品 repo 裡快速建立這份指標，並且刻意設計成「已存在就不覆蓋、只回報」，避免不小心蓋掉別人手動調整過的內容。

這加起來其實就一句話：每個產品 repo 只放路標，完整規則永遠只留在共用工具箱那一份。

有了共同入口後，下一個問題是：知識庫該從哪裡開始長？總不能一次把所有領域知識都塞進去。

下一篇來談。